home *** CD-ROM | disk | FTP | other *** search
/ Internet Info 1994 March / Internet Info CD-ROM (Walnut Creek) (March 1994).iso / networking / terms / kermit / c / c64ker.get < prev    next >
Encoding:
Text File  |  1992-09-28  |  9.5 KB  |  219 lines
  1.        Building C-64/128 Kermit v2.2 (73) from C64KER.HEX and C64KER.INI
  2.                           Last updated: August 23, 1992
  3.                      by Kent Sullivan (kentsu@microsoft.com) 
  4.  
  5. These instructions describe how to build C-64/128 Kermit v2.2 (73) from the
  6. ASCII text files in the Columbia U. archives (or Tape C of the Kermit
  7. distribution tapes).  This method, also known as "bootstrapping", is provided
  8. for those people who have no file-transfer program with which to obtain the
  9. ready-to-run Kermit binaries which are also kept in the Kermit archives.
  10.  
  11.  
  12. Required Files and Equipment
  13. ----------------------------
  14.  
  15. The following files are needed in order to build Kermit v2.2 (73):
  16.  
  17. 1) C64BOOT.BAS
  18. 2) C64BOOT.C
  19. 3) C64KER.HEX
  20. 4) C64KER.INI
  21. 5) C64KER.GET (this file)
  22.  
  23. All of these files are available from Columbia U. (archives or tape C).
  24.  
  25. The following equipment is needed in order to build Kermit v2.2 (73):
  26.  
  27. 1) Host computer from which the Kermit files will be sent
  28. 2) C language compiler on host computer
  29. 3) Dial-in (modem) access to the host computer
  30. 4) C-64 or C-128 computer
  31. 5) Disk drive compatible with C-64/128 (tape drives NOT supported)
  32. 6) 300 bps or faster modem compatible with C-64/128
  33. 7) Blank formatted disk (CBM)
  34.  
  35.  
  36. Part One: Getting the Files onto the Host Computer
  37. --------------------------------------------------
  38.  
  39. The directions for this part unfortunately cannot be very specific due to the
  40. wide variety of systems capable of hosting a Kermit build.  The goal is to
  41. transfer the necessary files from Columbia U. (archives or tape C) to the host
  42. computer (most likely a mainframe or minicomputer where you have an account).
  43. The necessary files are listed in the Overview section of the document.
  44.  
  45. If your host computer has Internet access, transferring the files will be as
  46. easy as using the FTP utility to create a copy of the files.  If your host
  47. computer does not have Internet access, you will need to have your system
  48. administrator copy the necessary files from Tape C of the Kermit distribution
  49. to your account on the host computer.
  50.  
  51.  
  52. Part Two: Preparing for the Download
  53. ------------------------------------
  54.  
  55. 1) Use the host computer's C language compiler to compile C64BOOT.C.  If the
  56.    C compiler reports any errors, check with your system administrator to see
  57.    if your host computer requires the program to be changed to work properly.
  58.    (The program is known to work fine as-is on the majority of computers
  59.    running the Unix operating system.)
  60.  
  61. 2) Examine the file C64KER.HEX.  Make sure that all of the alphabetic
  62.    characters are in lower case.  If they aren't, use a utility on the host
  63.    computer to make them so.  (On Unix systems, use the TR utility.)
  64.  
  65. 3) Print out the file C64BOOT.BAS.  Type this program in on your C-64/128
  66.    in uppercase/lowercase mode (not uppercase/graphics mode).  You'll know
  67.    you're in the right mode when you can see both uppercase and lowercase
  68.    letters simultaneously as you type.
  69.  
  70. 4) Carefully check C64BOOT.BAS against the printout and correct any errors.
  71.    (Note: you can leave out a lot of the spaces which are included in the
  72.    program listing.  The spaces were added to improve the readability of the
  73.    printout only.)
  74.  
  75. 5) Save the completed C64BOOT.BAS program to a blank formatted CBM disk.
  76.  
  77.  
  78. Part Three: Downloading C64KER.HEX
  79. ----------------------------------
  80.  
  81. 1) Make sure your C-64/128 and modem are operating correctly.
  82.  
  83. 2) Load C64BOOT.BAS.
  84.  
  85. 3) Check the communication parameters of the host computer.  Make sure the
  86.    parameters match those of C64BOOT.BAS.  The default communication parameters
  87.    for C64BOOT.BAS are: 300 bps, 8 bit word size, no parity bit, 1 stop bit
  88.    (often abbreviated "8-N-1").  To change any of these parameters, modify the
  89.    first OPEN statement in line 50.  Some of the other common values are given
  90.    below.  If you need some other setup, consult the RS-232 charts in a
  91.    C-64/128 reference guide.
  92.  
  93.     300 bps, 7-O-1 (7 bits, odd parity): OPEN 1,2,0,CHR$(38) + CHR$(32)
  94.     300 bps, 7-E-1 (even parity)       : OPEN 1,2,0,CHR$(38) + CHR$(96)
  95.     300 bps, 7-M-1 (mark parity)       : OPEN 1,2,0,CHR$(38) + CHR$(160)
  96.     300 bps, 7-S-1 (space parity)      : OPEN 1,2,0,CHR$(38) + CHR$(224)
  97.   
  98.    Note that C64BOOT.BAS is limited to 300 bps communication speed in its
  99.    default form because it is written in BASIC, and BASIC is slow.  If you have
  100.    access to a C-64 BASIC compiler (Petspeed, Blitz, BASIC-64, etc.) you could
  101.    try bumping the speed up to 1200 bps.  This idea is untested but has a fair
  102.    chance of working.
  103.  
  104.    Also note that C64BOOT.BAS is set for full-duplex (not half) communication.
  105.  
  106. 4) Run C64BOOT.BAS.
  107.  
  108. 5) Call the host computer.  The procedure for doing this will vary according to
  109.    the type of modem you have for your C-64/128.  C64BOOT.BAS does not have an
  110.    autodial feature, so if you cannot send a dial string to the modem from
  111.    terminal mode (like "ATDT <number>" for a Hayes modem) then you will need
  112.    to dial the number manually.
  113.    
  114. 6) Once connected to the host computer, log into your account.
  115.  
  116. 7) Make sure the host computer's terminal settings are for (a) no echo and
  117.    (b) end of line character sent to your terminal equals linefeed (ASCII 10).
  118.    The procedure for checking and setting this varies widely from computer to
  119.    computer.  On a Xenix system I used recently, I used the command STTY to
  120.    check the terminal settings.  I then used the following arguments to STTY
  121.    to set things correctly:
  122.  
  123.     STTY -ECHO -ONLCR -OCRNL
  124.  
  125.    These settings may very well not work for your situation but are provided as
  126.    an example.  Consult with your system administrator for assistance.  Note:
  127.    If it is impossible to have the host computer send ASCII 10 for an end-of-
  128.    line character but it can send ASCII 13 (carriage return), change the
  129.    CHR$(10) commands to CHR$(13) in lines 205 and 225 of C64BOOT.BAS.
  130.  
  131. 8) Start the program you compiled from C64BOOT.C earlier.  You need to specify
  132.    the file to be downloaded (C64KER.HEX) on the same command line.  Example:
  133.  
  134.     C64BOOT C64KER.HEX   (assuming that you named the download program C64BOOT)
  135.  
  136.    Note: You will not receive any feedback that C64BOOT has started properly
  137.    (there is no startup message).  You will probably also not be able to see
  138.    what you are typing since you have previously told the host computer to not
  139.    not echo what you type.
  140.  
  141. 9) Press the <F1> key on your C-64/128.  C64BOOT.BAS will prompt you for a
  142.    local filename.  Respond with the name "kermit" (lowercase, no quotes) and
  143.    press the Return key.
  144.  
  145. The host computer should then begin sending C64KER.HEX, one line at a time.
  146. C64BOOT.BAS receives each line and calculates two checksums on each line.  If
  147. the line is ok, C64BOOT.BAS will print a period (".") on your C-64/128's
  148. screen and write the data to the disk.
  149.  
  150. If there was a transmission error, such as static on the phone line,
  151. C64BOOT.BAS will print "Checksum Error - sending nack" on your screen.  The
  152. "nack" means Negative ACKnowledgement and will cause the host computer to re-
  153. send the line.  This error can also occur if the terminal parameters for the
  154. host computer have not been set correctly or if the communication parameters
  155. of the host computer and those in C64BOOT.BAS do not match.
  156.  
  157. If C64BOOT.BAS detects an error in the data itself, however, it will print
  158. "Data file bad." and will stop execution.  This error will occur only if the
  159. C64KER.HEX file has somehow become corrupted.
  160.  
  161. The file C64KER.HEX is over 1300 lines long, and each line takes about 6
  162. seconds to be transmitted.  Tests I have done show that the transmission takes
  163. about 2 - 2.5 hours if no or few transmission errors are encountered.
  164.  
  165. When transmission is finished, C64BOOT.BAS will print:
  166.  
  167.       kermit downloaded; returning to terminal mode
  168.  
  169. At this point you should log out of the host computer, then exit C64BOOT.BAS
  170. by pressing the <F7> key.
  171.  
  172. Check the size of the file "kermit": it should be 120 disk blocks.
  173.  
  174.  
  175. Part Four: Creating KERMIT.INI
  176. ------------------------------
  177.  
  178. 1) Print out the file C64KER.INI.  Type this program in on your C-64/128
  179.    in uppercase/lowercase mode (not uppercase/graphics mode).  You'll know
  180.    you're in the right mode when you can see both uppercase and lowercase
  181.    letters simultaneously as you type.
  182.  
  183. 2) Carefully check C64KER.INI against the printout and correct any errors.
  184.  
  185. 3) Save the completed C64KER.INI to disk.  (You can give it a more meaningful
  186.    name, such as "MAKE KERMIT INI", if you wish.)
  187.  
  188. 4) Run C64KER.INI.  The program will create the file KERMIT.INI, which contains
  189.    initialization parameters required by C-64/128 Kermit.  Note: Always keep
  190.    a copy of KERMIT.INI on the same disk as KERMIT.  KERMIT will not work
  191.    without KERMIT.INI.
  192.  
  193. 5) Check the size of the file "kermit.ini": it should be 1 disk block.
  194.  
  195.  
  196. Part Five: Running Kermit for the First Time
  197. --------------------------------------------
  198.  
  199. 1) Load the file "kermit".  Load it as a BASIC program, e.g.:
  200.  
  201.     LOAD "KERMIT",8
  202.  
  203. 2) Make sure the disk with KERMIT.INI on it is in the disk drive.
  204.  
  205. 3) Run KERMIT.
  206.  
  207.    The disk drive light should come on for a second then you should see the
  208.    Kermit startup message on your screen, at the top.
  209.  
  210. Assuming that everything is working properly, it would be a good idea to use
  211. Kermit to download C64KER.DOC, the user guide for C-64/128 Kermit.  You may
  212. want to use a text editor on your host computer to break the file up into
  213. smaller chunks (7 would be good) to make the file easily viewable/printable
  214. via a C-64/128 word processor or similar utility.
  215.  
  216. Finally, if you have a C-128 and would like KERMIT to autoboot on it, you
  217. can type in C64KER.SEC.  This program, when run on your C-128, creates an
  218. autoboot sector for KERMIT.
  219.